From: Eli Zaretskii <eliz@gnu.org>
Date: Wed, 8 Apr 2009 14:05:38 +0000 (+0000)
Subject: (append-to-file): Doc fix.
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1~1^2~421^2~924
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=5cbad4524e63097d47511aefbce811041a2a3940;p=emacs.git

(append-to-file): Doc fix.
---

diff --git a/lisp/files.el b/lisp/files.el
index 7c792c96c52..499948c4176 100644
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -4475,8 +4475,14 @@ Don't call it from programs!  Use `insert-file-contents' instead.
 (defun append-to-file (start end filename)
   "Append the contents of the region to the end of file FILENAME.
 When called from a function, expects three arguments,
-START, END and FILENAME.  START and END are buffer positions
-saying what text to write."
+START, END and FILENAME.  START and END are normally buffer positions
+specifying the part of the buffer to write.
+If START is nil, that means to use the entire buffer contents.
+If START is a string, then output that string to the file
+instead of any buffer contents; END is ignored.
+
+This does character code conversion and applies annotations
+like `write-region' does."
   (interactive "r\nFAppend to file: ")
   (write-region start end filename t))